Atlassian Integration Guide : Dragons Stage 6 - Get JIRA and FishEye Talking

This page last changed on Apr 28, 2011 by smaddox.

You are embarking on stage 6 of the Atlassian Dragon Quest. Be prepared to ride on the dragon's back, for he is swift and strong and will take you where you need to go.

In this stage you will configure JIRA and FishEye, so that you will be able to see code commits in JIRA and see JIRA issues in FishEye.

Time estimate: This stage will take approximately 15 minutes.

On this page:

Step 1. Add a JIRA-FishEye Application Link
Step 2. Link a FishEye Repository to a JIRA Project and Subscribe JIRA to FishEye Gadgets
Step 3. Configure the FishEye Plugin in JIRA
Step 4. Add a FishEye Gadget to JIRA
Victory!

Step 1. Add a JIRA-FishEye Application Link

In this step you will link your JIRA and FishEye servers by creating an application link.

Go to your FishEye URL in your web browser, e.g. http://localhost:8060/.
Click the downward-pointing arrow next to your username (i.e. 'Charlie of Atlassian') then click 'Administration' in the dropdown menu to go to the FishEye Admin screen.
Click 'Application Links' in the left-hand panel.
The 'Configure Application Links' screen will appear. Click 'Add Application Link'.
The first screen of the 'Add Application Link' wizard will appear. Copy the base URL for your JIRA site (e.g. http://coopers:8080 or http://www.foobar.com:8080) and paste it into the 'Server URL' field.
Click 'Next'.
The 'Link to JIRA' screen will appear. Enter the following information:
- Create a link back to this server – This option is selected by default. Let it remain selected.
- Username: charlie. This is the username of the administrator on your JIRA site.
- Password – Enter Charlie's password in JIRA.
- Reciprocal Link URL – Leave this field at its default value, pointing to your FishEye site.
Click 'Next'.
The 'Set Users and Trust' screen will appear. Enter the following information:
- The servers have the same set of users – This option is selected by default. Let it remain selected.
- These servers fully trust each other – This option is selected by default. Let it remain selected.
Click 'Create'. The application link will be created and displayed on the 'Configure Application Links' page.
Click 'Configure' next to the 'Your Company JIRA' application link.
Change the 'Application Name' to Dragons JIRA and click 'Update'.
Click 'JIRA Settings' next to the 'Dragons JIRA' application link.
The 'Update JIRA Server' screen will appear. Select the 'Include in Activity Streams' checkbox.
Click 'Save'.
Click the 'Server' link in the left-hand menu under 'Global Settings'.
The 'Server Settings' screen will appear. Click 'Edit Settings'.
The 'Edit Web Settings' screen will appear. Select the 'On' radio button next to 'Allow remote API calls'.
Click 'Update'.

Screenshot 1 (click to enlarge): Adding JIRA as a trusted application in FishEye

Step 2. Link a FishEye Repository to a JIRA Project and Subscribe JIRA to FishEye Gadgets

In this step you will link your FishEye repository to your JIRA project via a project link. This will enable the hyperlink on JIRA issue keys in FishEye and the summary popup window that appears when you move your cursor over a JIRA issue key. You will also make your FishEye gadgets available for use in JIRA.

Go to your FishEye URL in your web browser, e.g. http://localhost:8060/.
Click the downward-pointing arrow next to your username (i.e. 'Charlie of Atlassian') then click 'Administration' in the dropdown menu to go to the FishEye Admin screen.
Click the 'Repositories' link in the left-hand menu under 'Repository Settings'.
The 'Repositories' screen will appear. Click the cog icon next to your 'Dragons' repository and select 'Application Links' from the dropdown menu.
Click 'Add Link' then select 'Dragons JIRA (JIRA)' from the dropdown menu.
Click 'Create'. Your FishEye repository is now linked to your JIRA project.
Now you will make your FishEye gadgets available in JIRA, so that JIRA users will be able to add any FishEye gadget to their dashboards. Go to your JIRA browser window and click 'Dashboards' in JIRA's top navigation bar.
Click 'Add Gadget'.
The 'Gadget Directory' popup window will appear. Click 'Gadget Subscriptions'.
The 'Gadget Subscriptions' popup window will appear. Click 'Add Subscription'.
The 'Add Subscriptions' popup window will appear. Copy the base URL for your FishEye site (e.g. http://coopers:8060 or http://www.foobar.com:8060) and paste it into the text box on the screen.
Click 'Add Subscription'.
Click 'Finished'.
The FishEye gadgets are now available in your JIRA gadget directory. You have not yet added them to your JIRA dashboard. We will do that in a later step.

Step 3. Configure the FishEye Plugin in JIRA

The FishEye plugin for JIRA is bundled as part of the JIRA package, so there is no need to install it. Now you will configure the plugin for your installation and configure JIRA to trust FishEye.

Go to your JIRA URL in your browser, e.g. http://www.foobar.com:8080.
Click 'Administration' in the top navigation bar.
The JIRA Administration console will open. Click 'FishEye Configuration' in the left-hand panel (in the 'Global Settings' section).
The JIRA FishEye configuration screen will appear. Click 'Edit Primary Configuration' at the bottom of the screen.
Enter the following information:
- Enable Crucible Integration: Yes
- Review Search Method: Both
Leave all the other fields at their default values and click 'Update'.
Click 'Application Links Configuration' at the bottom of the screen.
Click 'Trusted Applications' in the 'Outgoing Authentication' column for your FishEye/Crucible link. If prompted, log in to FishEye.
Click 'Modify' and enter the following information:
- 'IP Patterns': Enter the IP addresses of your FishEye/Crucible site, separated by commas. For example: 127.0.0.1, 172.20.5.95.
  You can find the IP addresses of your FishEye/Crucible site by viewing the 'Remote Addresses' tab for the FishEye application in Crowd.
Click 'Apply'.
Click 'Incoming Authentication' in the left-hand menu.
Click 'Modify' and enter the following information:
- 'IP Patterns': Enter the IP addresses of your JIRA site, one per line. For example: 127.0.0.1, 172.20.5.95.
- 'URL Patterns': Enter the following paths, one per line:
  - /plugins/servlet/streams
  - /sr/jira.issueviews:searchrequest
  - /secure/RunPortlet
  - /rest
  - /rpc/soap
Click 'Apply' and then 'Close'.

Try It Out!

There is now a 'Source' tab on your JIRA issues. Open your 'DRA-1' issue and click the new 'Source' tab. The tab shows the changesets related to the issue, i.e. changesets where the JIRA issue key was included in the commit message.

Screenshot 2 (click to enlarge): Source tab on a JIRA issue

There is now also a 'Source' tab on your JIRA project. Open your 'Dragons' project to see the new tab. (Click the dropdown arrow next to 'Projects' in the top navigation bar, then click the 'Dragons (DRA)' project.) The 'Source' tab shows the most recent changesets related to any issue in the project, provided the changes were committed in the last 30 days.
We committed our changes to the 'Dragons' repository more than 30 days ago, so you will not see any commits on the JIRA project tab. The screenshot below shows you what they would look like.

Screenshot 3 (click to enlarge): Source tab on a JIRA project

You can click through from JIRA to view a changeset or other repository views in FishEye. To try it, go to the 'Source' tab on your 'DRA-1' issue and click the changeset number ('1') or the repository name ('Dragons').

In FishEye, you can see a popup summary of issue information for an issue key. Try it by moving your cursor over 'DRA-1' in your FishEye view. You can also click through from FishEye to JIRA by clicking the issue key.

Full details are in the JIRA documentation.

Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
Victory? Please continue.

Step 4. Add a FishEye Gadget to JIRA

Now you will add the 'FishEye Charts' gadget to your Dragon Development Dashboard.

Click 'Dashboards' at top left of your JIRA screen.
Your 'Dragon Development Dashboard' will appear. Click 'Add Gadget'.
The 'Gadget Directory' will appear, showing a list of the available gadgets for your JIRA dashboard. Enter 'FishEye' into the search box at top right of the Gadget directory screen.
The list of gadgets will change, to show only the gadgets that match your search term. Find the 'FishEye Charts' gadget and click 'Add it Now'. The gadget will be highlighted for a short time and the button's wording will change to 'Adding', while JIRA adds the gadget to the dashboard.
Click 'Finished' to go back to your dashboard.
Configure the 'FishEye Charts' gadget:
- Enter 'Dragons' in the 'Repository' field.
- Click the dropdown arrow next to 'Refresh Interval' and select 'Every 15 Minutes'.
- Click 'Save'.
Choose a different colour for your 'FishEye Charts' gadget:
- Move your cursor pointer over the gadget and click the downward-pointing arrow at top right of the gadget frame.
- Select the orange square in the row of colours.

Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
Victory? Please continue.

Victory!

Your JIRA dashboard now has 5 gadgets:

The 'FishEye Charts' gadget
The Confluence 'Activity Stream' gadget
The 'Assigned to Me' gadget
The 'Projects' gadget
The GreenHopper 'Agile' gadget

Screenshot 3 (click to enlarge): JIRA dashboard with 5 gadgets

Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
Victory? Please continue.